home *** CD-ROM | disk | FTP | other *** search
/ Compendium Deluxe 1 / LSD Compendium Deluxe 1.iso / a / intuition / window / wbvwm20.lha / WBvwm.doc < prev    next >
Encoding:
Text File  |  1993-10-07  |  5.8 KB  |  171 lines
  1.                                 WBvwm V2.0
  2.                              (formerly WBvsm)
  3.                       Workbench Virtual Window Manager
  4.  
  5.                    Copyright (C) 1993 by Juhani Rautiainen
  6.                 WBvwm requires Workbench version 2.04 or higher.
  7. *****************************************************************************
  8.  
  9.     This program  is copyrighted by Juhani Rautiainen, but can be
  10.     freely distributed, providing that the following rules are
  11.     respected.
  12.     - No change is made to program nor the accompanying documentation
  13.     - The package is always distributed in its complete form consisting
  14.       of the 3 files: WBvwm, WBvwm.doc, WBvwm.info.
  15.     - Every form of distibution is allowed and encouraged, but no fee
  16.       can be charged for this program except for, possibly, the cost of
  17.       magnetic media and/or disk duplication and shipping.
  18.     - Inclusion in PD software libraries such as Fish Disks is allowed,
  19.       provided the fees charged for these disks are comparable with those
  20.       charged by Fred Fish.
  21.  
  22. *****************************************************************************
  23.  
  24. 1. What is WBvwm?
  25.  
  26.     With Workbench 2.04 we got ability to use bigger Workbench screen
  27.     than fits on display (virtual Workbench screen). Biggest problem
  28.     (atleast to me) was that scrolling around with mouse was too slow.
  29.     So I decided to make program like X-windows olvwm which also has
  30.     virtual screens and windows.First version of this program was called
  31.     WBvsm and is was basicly simple keyboard shortcut for moving around
  32.     virtual Workbench. This version has WBvwm-window and few functions
  33.     similar to original olvwm. To get most out of this program I
  34.     recommend that you also get MagicMenu program which is written
  35.     by Martin Korndörfer. MagicMenu version 1.22 or higher should do fine.
  36.  
  37. 2. Installation
  38.  
  39.     You can either drag WBvwm icon to your WBStartup drawer or copy
  40.     executable to your path and put WBvwm to your s:user-startup.
  41.     Program will detach itself from CLI so there is no need to run
  42.     it with run. If you put program into WBStartup remember to check
  43.     that Tool Type DONOTWAIT is set.
  44.  
  45.     Note: WBvwm patches following functions to be able to monitor windows:
  46.         CloseWindow()
  47.         OpenWindow()
  48.         OpenWindowTagList()
  49.  
  50. 3. How to use
  51.  
  52. 3.1 Terminology used
  53.  
  54.     Display:
  55.             This refers to the area you see on your monitor.
  56.  
  57.         Virtual Workbench:
  58.                 Is created by Prefs/ScreenMode program. You just
  59.         simply give Width and Height gadgets bigger values
  60.         than fit on your display. WBvwm works best if you
  61.         use multiples of your display size.
  62.         For example: Display is Pal Hires (640x256) and
  63.                              Workbench size is 1280x512. This
  64.                              means that you have 4 display areas
  65.                      for use.
  66.  
  67.     WBvwm-window:
  68.         This program uses little window which represents
  69.         visually the entire Workbench: it provides a
  70.                 scaled-down version if the entire Workbench.
  71.         Scale factor is 1/16. This window will follow
  72.         you when you change active display with WBvwm.
  73.         If you use Workbench's autoscroll feature it won't
  74.         follow you.
  75.  
  76.         Current display:
  77.         Area of Workbench which is currently on your display.
  78.  
  79.         Virtual window:
  80.                 is a small rectangle displayd in the WBvwm-window;
  81.         every window on the Workbench has a corresponding
  82.                 virtual window in the WBvwm-window.
  83.  
  84. 3.2 Using WBvwm-window
  85.  
  86.         WBvwm-window can be used for two purposes: moving windows
  87.     on Workbench or for changing active display.
  88.  
  89.     Moving windows:
  90.         You activate virtual window which you want to move with
  91.         SELECT button. You can now drag this window where you
  92.         want it to. After you release SELECT button window on
  93.         Workbench will move to this place.
  94.  
  95.     Changing active display:
  96.         Double click on the display area you want to move to.
  97.  
  98. 3.3 Using keyboard shortcuts
  99.  
  100.     There are currently five working keyboard shortcuts:
  101.  
  102.     Left Amiga + cursor left : Active display moves to left.
  103.                    + cursor rigth: Active display moves to rigth.
  104.                    + cursor up   : Active display moves up.
  105.                    + cursor down : Active display moves down.
  106.            + Del     : WBvwm-window comes up to front.
  107.     All the above moves happen only if there is still room to move.
  108.  
  109.  
  110. 3.4 About windows on WB
  111.  
  112.         If some other program tries to open window on Worbench WBvwm tries
  113.     to move it so that it'll open on current display.
  114.  
  115. 4. Options
  116.  
  117.     Sorry, but there aren't any except QUIT (see below).
  118.  
  119. 5. Removing WBvwm
  120.  
  121.     From CLI you should enter
  122.  
  123.         7. WORK> WBvwm QUIT
  124.  
  125.     if program is in your current path or simply close WBvwm window.
  126.     If program can't restore functions it has patched (some other
  127.     program has also done patches on those functions) it won't quit
  128.     if you don't force it to do so. If you force WBvwm to quit results
  129.     are somewhat unpredictable.
  130.  
  131. 6. Bugs, comments
  132.  
  133.     You can send me bug reports, comments and so on. If you get
  134.     Enforcer hits snapshots of these hits are appreciated.
  135.  
  136.     By E-mail:
  137.         jrauti@cs.joensuu.fi
  138.         (BTW my compulsory military service starts on the 10th of June
  139.          1993 and lasts atleast 9 1/2 months, so my responses to your
  140.          mail may take few weeks in worst case).
  141.  
  142.     or by ordinary mail:
  143.         Juhani Rautiainen
  144.         Ahmankatu 19
  145.         80130 Joensuu
  146.         Finland
  147.  
  148. 7. Thanks
  149.  
  150.     Thanks to SAS people for POPCLI-example which was base for
  151.     this program.
  152.  
  153.     Thanks for following people for help:
  154.  
  155.         Antti Miettinen     Kurt W Greiner
  156.         Timo Rossi              Tomas Pihl
  157.         Kari Sutela        Dan Griffin
  158.         Tom Westerinen        Manuel Lemos
  159.  
  160.     Thanks also to Martin Korndörfer for excellent MagicMenu which was
  161.     one of the reasons why I started this project.
  162.  
  163. 8. History
  164.  
  165. Version 2.0
  166.     - All new WBvwm window which tries to emulate X-window olvwm.
  167.  
  168. Version 1.2 (program was called WBvsm)
  169.     - First published version.
  170.     - This was basicly simple keyboard shortcut.
  171.